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Concept 


The University of Houston-Clear Lake established the Research Institute for 
Computing and Information systems in 1986 to encourage NASA Johnson Space 
Center and local industry to actively support research in the computing and 
information sciences* As part of this endeavor, UH-Clear Lake proposed^* 
partnership with JSC to jointly define and manage an integrated program of research 
in advanced data processing technology needed for JSC’s main missions, including 
administrative, engineering and science responsibilities. JSC agreed and entered into 
a three-year cooperative agreement with UH-CIear Lake beginning in May, 1986, to 
jointly plan and execute such research through RICIS. Additionally, under 
Cooperative Agreement NCC 9-16, computing and educational facilities are shared 
by the two institutions to conduct the research. 

The mission of RICIS is to conduct, coordinate and disseminate research on 
computing and information systems among researchers, sponsors and users from 
UH-Clear Lake, NASA/JSC, and other research organizations. Within UH-Ctear 
Lake, the mission is being implemented through interdisciplinary involvement oT 
faculty and students from each of the four schools: Business, Education, Human 
Sciences and Humanities, and Natural and Applied Sciences. 

Other research organizations are involved via the “gateway” concept. UH-Clear 
Lake establishes relationships with other universities and research organizations, 
having common research interests, to provide additional sources of expertise to 
conduct needed research. 

A major role of RICIS is to find the best match of sponsors, researchers and 
research objectives to advance knowledge in the computing and information 
sciences. Working jointly with NASA/JSC, RICIS advises on research needs, 
recommends principals for conducting the research, provides technical and 
administrative support to coordinate the research, and integrates technical results 
into the cooperative goals of UH-Clear Lake and NASA/ JSC. 
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User Documentation for the 
QMS and MSK Intelligent Tutoring System 


1. THE USER’S GUIDE 

This user s guide describes how to use the Intelligent Tutoring Systems for the Manual Select 
Keyboard (MSK) and the Orbital Maneuvering System (OMS) and how to use the C code that runs 
the Mockup version of the MSK. 


2. THE MSK ITS CODE 

2.1 Overview 


This section describes the following aspects of the MSK Intelligent Tutoring System: 

a. The directory structure and files maintained in each directory 

b. How to use the MSK ITS in interpreted and executable modes 

c. How to rebuild the interpreted and runtime versions of the MSK ITS using the makefiles 
provided. The system is compiled with the Apollo Domain X C compiler. 

22 Directory Structure 

The code for the MSK ITS exists in three sub-directories of the directory "/hrlits/mskits": 
graphics, tutor, and runtime. To see a listing of these directories, type "cd /hrlits/mskits" at the % 
prompt followed by the command "Is." 

2.2.1 The Graphics Directory 

The graphics directory contains the C source code and header files used to implement the 
graphic display of the MSK. The graphics directory also contains the object code generated by 
compiling the C source code. Figure 1 contains a listing of the files in the graphics directory. 

ese files create the representation of the MSK on the computer display, blowup objects on user 
request monitor student input during an exercise, coUect the speed of performance, generate a quiz 
during the overview of the tutor, and perform many other basic utilities of the ITS. 

2.2.2 The Tutor Directory 

The tutor directory contains the CLIPS code that implements the tutor’s instructional 

strategy, expert model, and student model and directs the flow of control in the ITS. Figure 2 

^ *^ es c ^ e tutor directory. The following files constitute the bulk of the 
CLIPS rules: 


a) buildex.clp - these rules construct the exercises 

b) cleanup.clp - these rules remove facts from the previous exercise and update information 
about the student prior to a new exercise 

c) evaluate.clp - these rules evaluate the student’s performance on an exercise and recommend 
a course of action 

d) exercise.cip - these rules perform a search of the exercise tree to determine what type of 
exercises the student should perform 

e) genextype.clp - these rules randomly generate exercise types based on the student’s needs 
during unguided, speeded, and automated phases of training 


2 


beep. c 

beep. o 

beeptext . c 

blovup obj . c 

blovup~obj . o 

blovup_panel.c 

blovup_panel.o 

ckfont 

cktext 

clr_text.c 

colors. c 

colors. o 

console 

console. c 

console. o 

console. t 

create plot.c 

ddd.h “ 

ddd. t 

defs . h 

demo_step. c 

demostep.o 

dispiay_plot.c 

display_plot.o 

display~text.c 

display“text.o 

draw_cons.c 

dravcons.o 

drav_goal_band . c 

drav_goal_band . o 

drav_goal_box. c 

drav_leds . c 

drav leds.o 


draw_obj . c 

drav_obj .o 

drav_panel. c 

drav_panel.o 

draw_plot.c 

draw plot.o 

drk. H 

drk. t 

exer.clp 

get_status.c 

get_status.o 

get_student_proc.c 

get_student_proc.o 

get~student“step.c 

get_student_step.o 

globals.c 

globals.o 

hilight.c 

hilight.o 

init_struc.c 

init_struc.o 

int_to_asc. c 

int_to_asc.o 

main.c 

main. o 

makefile 

makefile. t 

mbutn_update.c 

mbutn_update.o 

monitor .h 

msk.h 

msk. t 

num. txt 


objects. h 
panels. h 
plot.c 
plot.h 

pop_buttons.c 

pop_buttons.o 

position. c 

position. o 

quizl.c 

quizl.o 

quiz 1 text .c 

quizltext.o 

quiz2.c 

quiz2.o 

quiz2text.c 

quiz2text.o 

quizutil.c 

quizutil.o 

random. c 

random. o 

randomtot.c 

randomtot.o 

select . c 

select. o 

smek.h 

smek. t 

stdalone.c 

stdalone.o 

stopclk.h 

stopclk. t 

tan2f ile 

test.clp 

testdrav.c 


testplot 
testtext.c 
testtext.o 
textstring. h 
toggle. c 
toggle. o 
trainl.c 
trainl.o 
trainltext . c 
trainltext .o 
train2. c 
train2.o 
train2text.c 
train2text .o 
trends . c 
trends. c. bak 
t rends. o 
trends . tmp 
tutor .h 
tutor. t 
tutorutil. c 
tutorutil.o 
txtlin. txt 
unxclips.mak 
util.c 
util.o 
voicekey. h 
voicekey. t 
windows . h 
write_IO. c 
write 10. o 


Figure 1. Contents of the MSKITS/Graphics Directory 
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assign. clp 
autovork.ovl 
autovork. perf 
buildex. clp 
cleanup. clp 
cleanup. tmp 
console 
evaluate. clp 
evaluate2.clp 


exer. stack 
exercise. clp 
facts. clp 
funcalls.clp 
genextype.clp 
goals. clp 
graph. clp 
instruct. parms 
instructparms.c 


load. file 

parmsset 

rav 

remediate. clp 
resetcrit 
setparms 
skills. clp 
speed. ovl 
speed. perf 


speedvork. ovl 
speedvork. perf 
student. model 

tandy.ovl 
tandy.perf 
tanf ile 
toplevel.clp 
train. clp 
update. clp 


Figure 2. Contents of the MSKITS/Tutor Directory 
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f) remediate.clp - these rules control remediation by backtracking through the exercise tree 

g) toplevei.clp - these rules initiate startup of the MSK tutoring system 

223 The Runtime Directory 


The runtime directory contains the object code created by compiling the C and CLIPS files 
t also contains the executable version of the MSK ITS, called MSKITS (see Figure 3). In order 
o run t e executable version, the file "instruct.parms" must be present in the same directory and 
Sectbn F 24J P ^ " mSkitS '" Instruct P arms is created by running the PARMSSET executable (see 


The runtime directory also contains the C source code files located in the graphics directory 
as well as the C source code files generated by the "rules-to-C" function (see Section 2.5). ^ 

2 J. Using the MSK ITS 

2 J.l Using the Executable Version of the MSK ITS 

/l i». J ° , us ® the executable version of the MSK tutor, change directories to the 
/hrhts/mskits/runtime directory. At the % prompt, type "mskits." Be sure that the file 
instruct.parms is in the same directory. The executable version of the tutor can be run in any 
directory as long as instruct.parms is in the same directory. V 

232 Using the Interpreted Version of the MSK ITS 


At th,. 1 ? 6 mter P r< * ed version of the MSK ITS must be run from the /hrlits/mskits/tutor directory 
At the % prompt, type console." You will then get a CLIPS prompt and type as follows: ^ 


clips > (load "load.file") 
clips> (assert (load)) 
clips > (run) 


After the rules are loaded, type: 

clips > (reset) 
clips > (run) 


This will load the MSK ITS into memory. Once you have exited the tutor, 
(exit) at the CUPS prompt. This will return you to the Domain X system 


exit CLIPS by typing 
prompt. 


233 The Output Files Created by the MSK ITS 


t , , MSK JTS creates two output files for each student who uses the tutor. One file contains 

the student model and is identified by the student’s identifier and a ".ovl" extension (e.g. 

mark^’ewLv^f ° f ^ Cntire training tree ( see F ‘gure 4) and indicators 

markrng which of the nodes the student has completed. The student model also contains the speed- 

criterion and automate-cnterion lists. These lists are used during speeded and automated 
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a. out 

drav_panel.o 

msktutor3.c 

setup. h 

beep. c 

drav_plot.c 

msktutor3.o 

smek.h 

beep.o 

draw plot.o 

msktutor4. c 

stdalone. c 

beeptext . c 

drk.H 

msktutor4.o 

stdalone. o 

blowup obj.c 

get_status.c 

msktutor5.c 

stopclk.h 

blowup obj.o 

get_status.o 

msktutor5.o 

tan3f ile 

blowup_panel.c 

get_student proc.c 

msktutor6.c 

tandy . ovl 

blowup_panel.o 

get_student_proc.o 

msktutor6.o 

tandy.perf 

clips. h 

get_student step.c 

msktutor7.c 

testdraw.c 

clr_text . c 

get student step.o 

msktutor7 .o 

testtext.c 

colors. c 

gloEals.c 

objects. h 

testtext .o 

colors . o 

globals.o 

panels. h 

textstring.h 

console . c 

hilight . c 

parmsset 

toggle. c 

console . o 

hilight . o 

plot.c 

toggle. o 

create plot.c 

init_struc.c 

plot.h 

trainl . c 

ddd.h 

init_struc.o 

pop_buttons.c 

trainl.o 

deffacts.h 

instruct . parms 

pop_buttons.o 

trainltext.c 

defs.h 

int_to_asc.c 

position. c 

trainltext . o 

demo step.c 

int_to_asc.o 

position. o 

train2.c 

demo step.o 

main.c” 

quizl. c 

train2 . o 

dispiay_plot.c 

main.o 

quizl.o 

train2text . c 

display plot.o 

makefile 

quizltext.c 

train2text.o 

display_text . c 

makefile. bak 

quizltext.o 

trends. c 

display_text.o 

mbutn_update. c 

quiz2.c 

trends. o 

draw_cons.c 

mbutn_update.o 

quiz2. o 

tutor. h 

dravcons .o 

monitor .h 

quiz2text . c 

tutorutil. c 

draw_goal band.c 

msk.h 

quiz2text.o 

tutorutil.o 

draw_goal band.o 

mski ts 

quizutil.c 

util. c 

drav_goal box.c 

msktutorO. c 

quizutil.o 

util . o 

draw leds.c 

msktutorO.o 

random. c 

voicekey.h 

draw leds.o 

msktutorl.c 

random. o 

windows . h 

draw obj . c 

msktutorl.o 

randomtot.c 

write_IO.c 

draw obj . o 

msktutor2. c 

select. c 

write 10. o 

draw_panel. c 

msktutor2.o 

select. o 



Figure 3. Contents of the MSKITS/ Runtime Directory 
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Figure 4. The MSK Training Ti 





exercises to determine on which exercises the student needs to perform at the criterion set bv the 
instructor in the file "instruct. parms." 

The MSK ITS also creates a file that maintains the student’s reaction times and accuracy 
eyels from the speeded and automated exercises. This file is named using the student’s 
identification and a ”.perf' extension (e.g., george.perf). Each line in this file corresponds to a single 
exercise. The line format is as follows: 

a) training phase: 1 = unguided or guided; 2 = speeded; 3 = automated 

b) operation type: 1 = tv channel attach; 2 = display request; 3 = DDD format- 4 = AES 

format; 5 = flight select ’ ’ 

c) operation sub-type: 1 = tv channel attach, display request, flight select, AES select, or DDD 
select; 2 = AES deselect or DDD deselect; 3 = DDD reset operational limits; 4 = DDD 

reset critical limits, 5 = DDD select drive; 6 = DDD select datatype; 7 = DDD select lamp 
test v 


d) speed of performance: in seconds 

e) accuracy of performance: percentage of steps until error 

f) a list of l’s marking the number of accurate steps in the operation; each 1 signifies an 

accurate step ^ 

2.4. Setting MSK ITS Parameters 

Various parameters of the MSK tutoring system can be set by the user. The source code that 
implements parameter collection is in the file "instructparms.c" located in the tutor directory. The 
executable version of this file is called parmsset. To provide new parameters to the system, type 
parmsset" at the % prompt. After the user provides the parameter values based on system querv 
the executable will create the instruct.parms file. Instruct.parms must be in the tutor directory to 
run the MSK ITS in interpreted mode and in the same directory as the MSKITS executable. 

The parameters collected by parmsset include the following: 

a) Maximum Speed. This is the speed at which a student must be performing consistently to 
avoid remediation. 

b) Speed Criterion. The student must accurately perform two of each operation at or better 
than this speed in order to proceed to the automated exercises. 

c) Automate Criterion. The student must accurately perform two of each operation at or better 
than this speed and be accurate in responding to the secondary task to end training. 

d) Number of Beep Patterns. This number determines the size of the pool of possible beep 
patterns that will be selected from. 
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e) Number of Beeps in a Pattern. This number determines the length of the beep patterns. 

f) Number of Target Patterns. This is the number of patterns that the student must recognize 
and respond to on any given exercise. 

g) Percentage of Target Beep Patterns. This number determines the frequency that the system 
provides a target versus a distractor beep pattern to the student. 

h) Latency between Beep Patterns. The amount of time that elapses between beep patterns 
during an exercise. 

i) The system asks a series of questions to determine which of the five operations to train 
during the speeded and automated exercises. 

2*5 Changing the Rules and Modifying the C Code for the MSK ITS 

23.1 Changing the Rules for the MSK ITS 

Changing the rules in the CLIPS files located in the tutor directory will change the operation 
of the interpreted version of the MSK ITS but not the executable version. To modify a rule, change 
directories to the tutor directory and modify the corresponding file. Then run the tutor in the 
interpreted mode. 


If you wish to recompile the executable version of the MSK ITS following a change to the 
rules, perform the following steps: 

% cd /hrlits/mskits/tutor 
% console 

clips> (load "load.file") 
clips > (assert (load)) 
clips> (run) 

After the rules are loaded, type: 


clips > (rules-to-c "msktutor" 1) 
clips > (exit) 


This procedure produces eight source files named msktutorO.c through msktutor7.c. Copy these 
files to the /hrlits/mskits/runtime directory and then type: 


%copy msktutor*.c ../runtime 
% cd ../runtime 
% make mskits 


The mskits makefile will create the mskits executable. 
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2 -5-2 Modifying the C Source Code for the MSK ITS 


Any changes to a C source code file requires recompilation of that file and relinking the files 
to create "console." If you want to change only the interpreted version of the MSK ITS, chance 
directories to the /hrlits/mskits/graphics directory. Type "make" at the % prompt. This will 
recompile the file that was changed and relink the files. After this, copy "console" to the 
/hrhts/mskits/tutor directory, change directories, and run the interpreted version. 

If you want to modify the executable version of the MSK ITS, copy the relinked version of 
^console to the /hrlits/mskits/runtime directory and change directories. At the system prompt type 
make mskits." This will produce a new executable version of the MSK ITS. K 


3. The OMS ITS CODE 


3.1 Overview 


This section describes the following aspects of the OMS Intelligent Tutoring System: 

a. The directory structure and files maintained in each directory 

b. How to use the OMS ITS in interpreted and executable modes 

c. How to rebuild the interpreted and runtime versions of the OMS ITS using the makefiles 
provided. The system is compiled with the Apollo Domain X C compiler. 

3.2 Directory Structure 

The code for the OMS ITS exists in three sub-directories of the directory "/hrlits/omsits" - 
graphics, tutor, and runtime. To see a listing of these directories, type "cd /hrlits/omsits" at the % 
prompt followed by the command "Is." 

3.2.1 The Graphics Directory 

Sophies directory contains the C source code and header files used to implement the 
graphic display of the components of the shuttle orbital maneuvering system (OMS) and the VDT 
screens that are displayed on the propulsion console. This code also implements the static overview 
portion of the system. The graphics directory also contains the object code generated by compiling 
the C source code. Figure 5 contains a listing of the files in the graphics directory. These files 
create the representation of the shuttle OMS and VDT screens on the computer monitor, blowup 
o jects on user request, monitor student input during an exercise, collect the speed of performance, 
f^2 erate 3 ^ U,Z ^ ur ‘ n g overview of the tutor, and perform many other basic utilities of the OMS 


3.2.2 The Tutor Directory 

The tutor directory contains the CLIPS code that implements the tutor’s instructional 
strategy, expert model, and student model and directs the flow of control in the OMS ITS. Figure 

3 ^ st ‘ n § ^ es ' n tutor directory. The following files constitute the bulk of the 
CLIPS rules: 


a) DDD_overview.clp - these rules control the overview of the DDD panels on the propulsion 
console r r 


b) Diag_evaiuate.clp - these rules control remediation to MSK operations 

c) diag_exercise.cip - these rules perform a search of the exercise tree to determine what type 
of exercises the student should perform 

d) Diag_facts.clp - this file contains the facts asserted into working memory at start-up 
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DDD_overview. c 
DDD_overview_quiz . c 
DDD_overview_text. c 

OMS_overview. c 
OMS_overview text.c 
OMS_utils . c 
beep. c 
beep_text . c 
blowup_ob j . c 
blowup_panel . c 
build_press . c 
clr_text . c 
coast_mode . c 
colors . c 
console . c 
consol e_re set . c 
create_plot . c 
demo step.c 
dispTayll05 . c 
display_msk . c 
displav_plot . c 
display_screens . c 
display_temps . c 
display_text . c 
displayutil . c 
downstream_leak . c 

draw_cons . c 

draw_goal_band. c 

draw_gcral_box . c 

draw_leds . c 

draw_obj . c 

draw_panel . c 

draw plot.c 

qe t_3iag_answe r . c 

get_diagnostic step.c 

OMS.h 

plot . h 

f ailure . h 

voicekey . h 

objects . h 

displays .h 

textstring. h 


get_leak . c 
get_sensor . c 
get_status . c 
get_student_proc . c 
get_student_step . c 
get which. c 
gloEals . c 

he lium_system_f ailure . c 

hilight . c 

init_ddd . c 

init_struc. c 

int to_asc.c 

lealcs . c 

limits_disabled. c 
main. c 

mbutn^update . c 
overvTew_quiz . c 
plot.c 

pop_buttons . c 
popup. c 
position. c 

p re sent_di agnostics . c 

present_msk_tasks . c 

present_vdt . c 

press_sensor . c 

print_copy . c 

quizl . c 

quizltext . c 

quiz2 . c 

quiz2text . c 

quizutil . c 

random. c 

randomtot . c 

reset crit.c 

run_sTmulati on . c 

drk . h 
tutor . h 
msk . h 
defs.h 
stopclk.h 
limits .h 


select . c 

sensor failures. c 
start_3iag_sim. c 
stdalone . c 
system_func_text . c 
tank_leak . c 
temp_sensor . c 
test_diag_general . c 
test_helium. c 
test msk_tasks.c 
test3raw. c 
testtext . c 
toggle . c 
trainl . c 
trainltext . c 
train2 .c 
t rain2 text . c 
trends . c 
tutorutil . c 
update_1101 ptl.c 
update_11037c 
update_1105 . c 
update 1110. c 
util . c~ 

valve_failure.c 

valve_sensor . c 

write_1101_ptl .c 

write_1101_valve . c 

write_1103 .c 

write_1105.c 

write_1109.c 

write_1110.c 

write 10. c 

makefile 

makerun 

monitor .h 

ddd.h 

smek . h 

helium. h 

windows . h 

panels .h 


Figure 5. Contents of the OMSITS/Graphics Directory 
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1 iag_eval . clp 

’iag_exercise . clp 
.iag_facts.clp 
diag_msk . clp 
diag_update . clp 
facts. clp 
coast mode.ovl 2 
consoTe_prac . ovl2 
ddd_display . ovl2 
diag_gen.ovl2 
diag_unguided. ov!2 


oms_assign. clp 
oms_buildex . clp 
oms_cleanup.clp 
oms_evaluate . clp 
oms_exerci.se .clp 
oras_funcalls . clp 
gnd_prac.ovl2 
gnd^unguided . ovl2 
limits dis.ovl 2 

no_pro 5 lem. ovl2 
system_failures.ovl2 


oms_genextype . clp 

oms_goals.clp 

oms_graph.clp 

oms_overview. clp 

oms_remediate . clp 

oms_skill s .clp 

valve_fail.ovl2 

valve pos.ovl 2 
vdt_dTsplay . ovl2 
vdt unguided. ovl2 

load. file 


oms_toplevel . clp 
oms_train. clp a 

oms_update . clp 
templates . clp m 


Figure 6. Contents of the QMS ITS/Tutor Directory 
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e ) 

0 

g) 

h) 


i) 


j) 

k) 

l ) 
m) 
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Diag_msk.clp - these rules evaluate MSK operations 


Diag_update.clp - these rules control remediation during diagnostic training 
OMS_buildex.clp - these rules construct the exercises 


OMS_cleanup.clp - these rules remove facts from the previous exercise and update 
information about the student prior to a new exercise ^ 


OMS_genextvpe.cIp - these rules randomly generate exercise types during the 
phases of training based on student needs 


diagnostic 


OMS_overview.clp - these rules control the overview of the OMS pod components 
OMSj-emediate.clp - these rules control remediation by backtracking through the exercise 


OMS_toplevel.clp - these rules initiate the startup of the OMS tutoring system 

templates.clp - this file contains the templates (data structures) loaded at start-up 

The Runtime Directory 


The runtime directory contains the object code created by compiling the C and CLIPS files 
it also contains the executable version of the OMS ITS, called OMSITS (See Figure 7). 

, .I™ 6 direct0I T als ° contains the C source code files located in the graphics directory 

as well as the C source code files generated by the "rules-to-c” function. ^ 

3-3. Using the OMS ITS 


3-3*1 Using the Executable Version of the OMS ITS 

, J° us< ; the e * ecutable version of the OMS tutor, change directories to the 

/hrhts/omsits/runtime directory. At the % prompt, type "omsits." 

3-3.2 Using the Interpreted Version of the OMS ITS 

Type- The interpreIed versi0n of ,he OMS ITS must be ™ (r °"> >he /hrlits/omsits/tu.or directory. 


% console 

clips > (load "load.file") 
clips> (assert (load)) 
clips > (run) 
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main . c 
msktutorO . c 
msktutorl . c 


msktutor2 . c 
msktutor 3 . c 
msktutor 4 . c 


msktutor5 . c 
msktutor6 . c 
msktutor 7 . c 


Figure 7. Contents of the OMSITS/Runtime Directory 
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After the rules are loaded, type: 

clips> (reset) 
clips > (run) 

This will load the OMS ITS into memory. Once you have exited the tutor, exit CLIPS by typing 
(exit) at the clips > prompt. This will return you to the Domain X system prompt. 

333 The Output Files Created by the OMS ITS 

TTie OMS ITS creates two output files for each student who uses the tutor. One file contains 
the student model and is identified by the student’s identifier and a ".ovl2" extension (eg 
george.ovl2). The student model consists of the entire training tree (see Figure 8) and indicators 

marking which of the nodes the student has completed. This training tree teaches the expert 
knowledge shown by Figure 9. H 

The OMS ITS also creates a file that maintains the student's reaction times and accuracy 
levels from the guided and unguided diagnostic exercises. This file is named using the student’s 
identification and a ".perf extension (e.g., george.perf). Each line in this file corresponds to a single 
exercise. The line format is as follows: ^ 

1) 1 signalling that the system only covers guided or unguided exercises 

2) training level: 6 = VDT task; 7 = console reset; 8 = critical reset; 9 = diagnostic guided- 
10 = diagnostic unguided 

3) problem type: 1 = pressure sensor failure; 2 = temperature sensor failure; 3 = valve position 
sensor failure; 4 = limits disabled; 5 = dual pressure regulator failure; 6 = tank leak - 7 = 
downstream leak; 8 = no problem 

4) failed position: 0 if irrelevant; 1 or 2 for pressure sensor; A or B for valve position sensor 
and dual pressure regulators 

5) student’s answer: same format as 3 and 4 

6) diagnostic accuracy 

7) diagnostic speed 

8) this is followed by performance data on the MSK operations: 

- for each MSK operation, the type of operation, accuracy, and speed are recorded 

■ITie data for 3 through 7 are only recorded if the subject is in the diagnostic guided or unguided 
phases. The : data for 5 is recorded on in the diagnostic unguided phase. MSK performance indices 
are recorded for all phases. 
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Figure 9. The OMS Expert Model 


3.4 


Changing the Rules and Modifying the C Code for the OMS ITS 
3.4.1 Changing the Rules for the OMS ITS 

Changing the rules in the CLIPS files located in the tutor directory will change the operation 
of the interpreted version of the OMS ITS but not the executable version. To modify a rule, change 

directories to the tutor directory and modify the corresponding file. Then run the tutor in the 
interpreted mode. 

If you wish to recompile the executable version of the OMS ITS following a change to the 
rules, perform the following steps: 

% cd /hrlits/omsits/tutor 
% console 

clips > (load "load.file") 
clips> (assert (load)) 
clips > (run) 


After the rules are loaded, type: 


clips> (rules-to-c "omstutor" 1) 
clips > (exit) 

This procedure produces eight source files named omstutorO.c through omstutor7.c. Copy these 
tiles to the /hrlits/omsits/runtime directory and then type: 

% copy omstutor*.* ../runtime 
% cd ../runtime 
% make omsits 

The omsits makefile will create the omsits executable. 

3.42 Modifying the C Source Code of the OMS ITS 

Any changes to a C source code file requires recompilation of that file and relinking the files 
to create "console." If you want to change only the interpreted version of the OMS ITS change 
directories to the /hrlits/omsits/graphics directory. Type "make" at % prompt. This will recompile 
t e file that was changed and relink the files. After this, copy "console" to the /hrlits/omsits/tutor 
directory, change directories, and run the interpreted version. 

. } { y° u want modif y the executable version of the OMS ITS, copy the relinked version of 

^console to the /hrlits/ omsits/ runtime directory and change directories. At the system prompt type 
make omsits." This will produce a new executable version of the OMS ITS. 
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4. THE MOCKUP CODE 


4.1 Overview 

This manual will describe the following aspects of the MSK TUTOR mockup for the PC: 

1. Directory structure and the files associated with each directory 

2. How to use the TUTOR in an interpreted mode and as a runtime executable 

3. How to rebuild the interpreted and runtime versions via makefiles (The current version of 
the tutor is compiled with Microsoft C Ver. 5.10) 

42 Directory Structure 

The directory structure for the mockup and a brief description of the pertinent files is eiven 
below (See Figure 10). 

4.2.1 \PROJECT\MSK\BIN 

. ™ e , direct °ry \project\msk\bin contains copies of working executables and batch files 

described below: 


consoie.exe 

dio48.exe 

makeaiLbat 


The interactive version of the used to test new rules. This is quicker than 
recompiling MSK TUTOR every time. 

This file contains routines for configuring and controlling the ICS DI048 digital 
I/O card. Refer to the ICS DI048 Reference Manual for more information. 

A batch file to remake all the make files in the \project\msk\src subdirectories 
MSKTUTOR.EXE is the executable created. 


msk.dat - This file contains the configurable parameters for the msk software, 
msk.exe - Contains functions that: 

1) Call the msk software to monitor panel inputs and track the elapsed time for the procedure. 

2) Assert the string of student actions and elapsed time into CLIPS. 

3) Drive the switch monitoring software. Monitor panel switches and compile a list of switches 
as they are modified. 

4) Compare current input states to the previous input states to determine if a different group 
of switches has been modified than the previous group modified. If so, returns the group 
number of the current group modified. Otherwise, returns NULL. 

5) Add the input state of the group modified to the list of switches which have been modified. 

6) Calculate the elapsed time for the procedure. 
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Directory of C:\FROjECTVMSK\WORKINr, 

DELETED <0\R> 

LOAD.FIL 

RECORD. CLP 

TOPLEVELCLP 

ASSIGN.CLP 

GENEXTYP.CLP 

COALS. CLP 

MOCKUPFA.CLP 

TRAIN.CLP 

UPDATE. CLP 

SKILLS.CLP 

CLEANUP.CLP 

EXERCISE.CLP 

BUTLDEX.CLP 

EVALUATE.CLP 

Directory of C:\PROJECnMSK\SRC 

CONFIG < DIR> 

DI048 ^ DIR> 

MAIN < DIR> 

UTIL < DIR> 

CONSOLE <■ DIR> 

README.TXT 

Directory of C:\PROJECTyMSK\SRC\CONTlC 

CONFIG 
CNFGTESTC 
CONFIG. C 
CNFGTEST.DAT 
CNFGTEST.EXE 

Directory of C:\PROJECTyMSK\SRC\0IO4* 

DI048 
DI048.C 
DIODRVR C 


Directory of C:\PROJECTVMSK\SRC\MAiN 

LINK.RSP 

MSK 

INITPARM C 
MSKDRVRC 
MSK.C 

Directory of C:\PROJECT\MSK\SRC\imL 

UTIL. LIB 
UTIL 
BITOPS C 
SWITCHOP.C 

Directory of C;\PROJECTVMSK\SRC\CONSOLE 

DELETED <DIR> 

BEEP.C 

DISPTEXT.C 

DUMMIES.C 

CETSTAT.C 

GETPROC.C 

GLOBALS.C 

CONSOLE 

QUIZLTT7L.C 

TRENDS.C 

TUTRUTILC 

MAIN.C 

RANDOM C 

MODTRUNC.C 

LIB.RSP 

CONSOLE.C 

LINK.RSP 


Directory of C:\PR0JECT\MSK 

MSKTUTOR < DIR> 

BIN <DIR> 

DOC < DIR> 

INCLUDE < D1R> 

LIB <DIR> 

WORKING < DIR> 

SRC < DIR> 

README.TXT 

Directory of C:\PROJECTMSK\MSKTLT0R 

TUTORO.C 

TUTOR1 C 

TUTOR2.C 

TUTOR3C 

MSKTUTOR.C 

TUTOR4C 

MSKTUTOR 

TUTOR5.C 

TUTOR6 C 

TUTOR7C 

README.TXT 

LINK.RSP 

MSKTUTOR RSP 

MAIN.C 

LOAD.FIL 

SETUP.H 

Directory of C:\PROJECT\MSK\BIN 

DI048.EXE 
MAKEALLBAT 
MSK.DAT 
MSKGOOD EXE 
README.TXT 
CONSOLE.EXE 
MSKTUTOR EXE 
MSK.EXE 


Directory of C:\PROJECAMSK\DOC 

PARTLIST 

BOARD.DRW 

PANELDRW 

SWTTCHES.DRW 

TITLE. WP 

SWLABELS.WP 

DIOCHANS 

MCCONECT 

SWCHANS 

SWCONECT 

Directory of C:\PROJECT\M55K\INCLUDE 

0104$. H 

CONFIG.H 

README.TXT 

MSK.H 

MOCKUP.H 

Directory of C:\PROJECT\MSK\UB 

CO NRG. LIB 

DI048.LIB 

UTILUB 

MSKTUTOR.LIB 

CONSOLELIB 

SD.LIB 

MSK. LIB 

README.TXT 


Figure 10. The Directory Structure of the MOCKUP C Code 
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mskgood.exe 

msktutor.exe 


Test file msk driver. 


The compiled version of the C code created by the rules together with the 
CLIPS code that runs without the CLIPS user interface. 

4.2.2 \PROJECT\MSK\DOC 

The directory \project\msk\doc contains the documentation on hardware configuration. 
423 \PROJECT\MSK\INCLUDE 

The directory \project\msk\include contains the header files for the MSK TUTOR C Code. 
4.2.4 \PROJECT\MSK\LIB 

directory \project\msk\lib contains the object code libraries created by specific 
makefiles. J * 


423 \PROJECT\MSK\MSKTUTOR 


The directory \project\msk\msktutor contains: 


a. main.c for runtime version only 

b. setup.h with the runtime flag set 

c. the makefile, called msktutor, which creates the MSK TUTOR executable 

d. tutorO.c - tutor7.c files created in \project\msk\working 


The difference between the main.c program in this directory and the main.c in the 
\project\msk\src\console directory is that this main.c does not include any user defined functions 

It also has a ddferent calling sequence to CLIPS. These differences are necessary when creatine 
a runtime version of rules. 


4-2.6 \PROJECT\MSK\SRC 

The directory \project\msk\src contains the subdirectories with the C code for the tutor. 

a. \config - contains C routines to configure parts of the control panel 
b card 48 * C ° ntainS the C functions needed t0 configure and control the ICS DI048 digital I/O 

c. \main - contains the C routines that builds msk.exe, which is described above. 

d. \util - contains bitops.c which is composed of routines for bit field manipulation and 
switchop.c which contains routines for msk switch operations. 

e. \console - contains C routines which make up the interpreted version of the tutor, called 
console.exe, described above. It is used to test new rules. 

f. \working - directory where clips rules are tested and then compiled into C code 
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43 Using the Tutor 

43.1 Running the Interpreted and Executable Versions 

To run the tutor in an interpreted mode, go to the \project\msk\working directory and type: 

C> console 
clips> (load "load.fil") 
clips > (assert (load)) 
clips > (run) 
clips > (reset) 
clips > (run) 


This will result in all facts and rules being loaded into memory. Next, the system will prompt 
you for a student identification. You are then asked which of the tasks the student is to perform. 
You may choose any combination of the tasks. For each positive response, the student will be 
expected to perform four trials at 100 percent accuracy. If the student makes an error, that trial 
does not count as far as completion is concerned, but all trials are written to the student’s record. 

As soon as the last question about tasks is answered, the first exercise is displayed on the 
screen. Also at that time the student’s output file is opened to record that student’s progress. From 
the moment the exercise appears to the moment the student presses the return key is referred to 
as the "read time." Then, as each step is completed, the time for that step is recorded, and when 
the final return is pressed, the overall time is calculated. At this point, the tutor will display each 
step tor the exercise and whether or not the student performed the step accurately. If all steps are 
correct, then the overall time for the exercise is displayed. Finally, the system will ask if the student 
wishes to continue. 

To ™ thC tUt ° r aS 30 executab,e ’ y° u do not ne ed to be in any specific directory as long as 
the PCs path name includes the directory where the msktutor.exe resides. (Normally in 
\project\msk\bin). Then type: 

C> msktutor 

The tutor will run in the same manner described above. : 5 
433 Output Files Created by the Tutor 

The tutor creates a single output file, named after the student. For example, if the student’s 
name is Bill, then the output file is "bill." An example of a student’s output is given below. In the 
first example, the student performed the task accurately, and in the second, an error was made 
Observe in the second example, an arbitrary speed of fifty is assigned since speed is not the primary 
factor when the student is inaccurate. 
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Example 1: 


msk_ddd_format_select 

Read Instruction Time 1.64999998 

student_step 1 0 function_code_thumbwheel 1 ok time 0 

student_step 2 0 mode_select _pbi ddd fmt sel ok time 4.82999992 

student_step 3.0 lever_switches 4440 ok time 8.39999962 

student step 4 0 data_type_pbi sim_playback2 ok time 2.20000005 

student_step 5 0 enter_switches left_mon enter ok time 1.87 

student_step 6 0 procjdone on ok time 0~ 

accuracy_list 100 

speedjist 17.35000038 

end 


Example 2: 


msk_tv_channel_attach 

Read Instruction Time 0.82999998 

student_step 1 0 function_code_thumbwheel 1 ok time 0 

student_step 2 0 mode_se!ect_pbi tv_chan ok time 3.3499999 

student_step 3 0 lever_switches 50 ok time 4.94000006 

student_step 4 1 enter_switches right mon enter bad time 1.70000005 

accuracyjist 57.1428566 

speedjisl 50 

end 


4.4 Changing the Rules and Modifying the C Code 


f . nn ' ai ] gmg on Jy the rules Wl11 not affect the interpreted version of the tutor and therefore is 
f ° r t6Sting ChangSS t0 the rules ‘ 0nce y° u are satisfied that the changes work 
steps m^o^h^ 611 W3nt ^ reCOmpile the runtime version, msktutor.exe. Perform the following 


C> cd \project\msk\working (this should be the directory where changes occur") 
C> console ■ 5 ’ 

clips > (load "Ioad.fiT) 
clips> (assert (load)) 
clips > (run) 

clips> (rules-to-c "tutor" 1) 
clips > (exit) 


At this point, you should have eight source files named tutorO.c - tutor 7.c. 
to \project\msk\msktutor and then type; 


Next, copy these 


C> cd \project\msk\msktutor 
C> make msktutor 
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The 

directory. 


msktutor makefile will create the msktutor.exe and place it in the \project\msk\bin 


Any changes to the C code requires a recompilation of that particular file via the makefile 
in the directory where the C file resides. For example, if you change the mskx file in 
\project\msk\src\main, you perform the changes and then type: 

C> make msk (do not confuse the C source files and the make file names) 

Unless you are in \project\msk\src\console directory already, type the following: 

C> cd \project\msk\src\console 

Then type: 

C> make console 

This rebuilds the entire console.exe. Then, as described above, you must rebuild msktutor.exe. 
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